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COM PERSISTENCE MODEL 

Field of the Invention 
The present invention is related generally to computer software and 
object oriented programming. More specifically, the present invention is 
related to software for persistently storing objects having pointers to other 
objects. The present invention includes software and methods for storing 
objects to persistent storage, storing pointers as unique identifiers, and 
restoring those pointers. 

Background of the Invention 

Object oriented programming is well known and veiy well established. 
Examples of object oriented programming languages include C++ and 
Smalltalk. Object oriented programming may be viewed as including 
polymorphism and inheritance, along with some encapsulation and some late 
binding. Object oriented programming initially was expected to allow for a 
great deal of object re-use, where objects are created once, and shared or sold 
for less than the cost and uncertainty of developing the same or similar objects 
from scratch for different projects and within different organization. The 
promise of object re-use was not immediately realized. What little re-use was 
provided was often in the form of class source code in one language that would 
hopefully compile across multiple platforms. 

Languages like C++ offer encapsulation, meaning the encapsulation of 
data, by separating the data from the access to that data. Encapsulation may 
be viewed as separating what an object looks like, e.g., the object interface, 
from how it actually works, e.g., the object implementation. C++ provides 
encapsulation, but in effect provides both interface and implementation 
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simultaneously. Attempts have been made to separate the implementation 
from the interface, with varying degrees of success. 

Object oriented programming provided more reusability with the 
advent of object-oriented programming that was more component oriented. 
5 Such component oriented programming may be viewed as including 
polymorphism, interface inheritance, very late binding, enforced 
encapsulation, and binary reuse. One commercial embodiment of 
component-oriented programming was Object Linking and Embedding 
(OLE), from Microsoft®. A later commercial embodiment of component 
10 oriented programming, derived from OLE, included Component Object Model 
(COM) objects, also provided by Microsoft®. 

COM objects provided interfaces separate from implementation, and 
allowed for multiple interfaces to each object. COM objects support the 
IUnknown interface, among others. COM further supports the inheritance of 
15 interfaces. Interfaces can be added or extended by users, enhancing the 
reusability. Components created that derive from IUnknown must support 
the IUnknown interface, and can support other interfaces, which are defined 
in an Interface Definition Language (IDL). A developer can use a system such 
as COM to create objects which, when compliant with COM, can be created as 
20 binary objects, used, and extended by a purchaser or user on remote 
computers. 

Binary objects having agreed upon and/or published interfaces can be 
created, used, and destroyed using these interfaces. Making the objects 
persistable is also desirable. Interfaces have been defined to make objects, for 
25 example, COM objects, to be persistently stored and restored from persistent 
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storage. Due to the extensibility of the objects, while the interfaces are 
defined, the implementation is left to the developer of the COM compliant 
object. Storing and restoring objects can be less than straightforward as the 
objects often have points referencing other objects, which will be in different 
locations when restored, and may not be in existence at the point in time when 
the pointer value is to be restored. 

What would be desirable, therefore, are methods and systems for 
providing persistent storage and retrieval for objects having pointers, and in 
particular, methods and systems for storing and restoring objects derived 
from component objects having defined interfaces. 

Summary of the Invention 

The present invention is related generally to computer software for 
persistently storing objects having pointers to other objects. More specifically, 
the present invention is related to software and methods for storing objects to 
persistent storage, storing pointers as unique identifiers, and restoring 
pointers, while restoring those pointers by so sheathing the pointers to class 
identifiers and creating the objects pointed to not in existence at the time of 
pointer restoration. The present invention provides a systematic method and 
software system for extending preexisting classes to support persistent 
storage. The present invention includes methods for saving objects to storage 
and loading the stored objects from storage back into memory. The present 
invention further includes methods for restoring pointer values to their proper 
values after a save and load cycle. The present invention preferably uses save 
and load methods for streaming the user objects from memory to a file and 
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from a file into memory. A preferred use of the present invention is to extend 
component object model (COM) objects to support persistence. 

In one aspect of the present invention, objects are registered in a 
Persistent Object Registry, preferably at the time of construction. The registry 
5 can include a unique object identifier for each object, as well as the class ID of 
that object class, and the IUnknown object from which that object derives. In 
one embodiment, each class ID ("CLSID") is a 128-bit representation that 
uniquely identifies a COM class. The Persistent Object Registry preferably 
maintains a collection of pointers grouped by class ID, object ID, and 
10 IUnknown. 

In another aspect of the present invention, pointers which are to be 
restored to proper values after a save and load cycle may utilize smart 
pointers. In another aspect of the present invention, objects utilize smart 
pointers rather than simple pointers. The smart pointers enable the 

15 restoration of pointer values after a save and load cycle. One embodiment of 
smart pointers includes a group ID, together with an address for the object 
being pointed to. In the C++ language, the assignment operator for pointers 
may be overloaded to make the smart pointers transparent to the person 
writing the code. During the assignment operation, the address of the object 

20 being pointed to is stored in a typical manner. In addition, the address of the 
object being stored is used to search the Persistent Object Registry to retrieve 
the object ID of the object being pointed to. In one embodiment, the object ID 
is retrieved directly from the object. 

In yet another aspect of the present invention, user-supplied save 

25 methods are used to stream objects to persistent storage. In a preferred 
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embodiment, the total number or numbers of classes having objects to be 
stored is written and/ or the total size requirement of the objects to be stored is 
written. For each class to be written to persistent storage, the class ID of that 
class and the number of objects of that class to be stored are preferably 
5 written to persistent storage, followed by the actual data of those objects. The 
actual data streamed to persistent storage is ultimately performed by a user- 
provided save method. The objects to be written out may thus be grouped 
according to class with objects of a class being written sequentially, followed 
by objects of the next class. 

10 In still another aspect of the present invention, a file to be loaded from 

persistent storage into memory may be loaded using the class ID of the COM 
persistence controller object used to control the saving of the objects to the 
file. The COM persistence controller object may first be constructed, together 
with the Persistent Object Registry. As each class ID is retrieved from the 

15 stream in, the objects of that class ID may be constructed and loaded. As the 
objects are loaded, they may be registered with the Persistent Object Registry 
in a manner similar to their initial construction and registration. The loaded 
objects may initially have invalid or null pointer values. 

After a portion of loading has been completed, or all of loading has 

20 been completed, the smart pointers may be restored to include valid object 
addresses. The smart pointers, containing the object IDs of objects being 
pointed to, may be resolved by using the Persistent Object Registry to retrieve 
the address of the object being pointed to using the object ID of the object 
being pointed to. The valid address may thus be set in the smart pointer. In 

25 some embodiments, a counter is incremented to track the number of objects 
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being registered In one embodiment, the value of this counter is used to 
assign values of the counter to the objects and/or to be used in managing 
Persistent Object Registry. The counter can be saved to persistent storage to 
preserve the current state of the objects when stored, and later loaded and 
restored, thus keeping track of the number of objects before the save and load 
cycle. 
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Brief Descrip tio n of the Drawing s 
Figure 1 is a class diagram of the classes used in an illustrative 
embodiment of the present invention; 

Figure 2 is an object interaction diagram for adding an illustrative 
5 persistent object to a COM persistent object controller; 

Figures 3A-3B are an illustrative object interaction diagram for saving a 
persistent registered COM object; and 

Figures 4A-4C are an illustrative object interaction diagram for loading 
COM objects from storage into a COM persistent object controller. 
10 Detailed Description of the Invention 

Figure 1 illustrates a class diagram of the classes used in an illustrative 
embodiment of the present invention. The three classes illustrated, including 
IPersistFile 20, IUnknown 28, and IPersistStream 36, are pre-defined by the 
COM (Component Object Model) specification, and classes defined according 
1 5 to the illustrative embodiment of the present invention are derived from these 
three basic classes. Persistent Object Factory Interface class 30 derives from 
IUnknown class 28 and exists in large part to provide the factory interface for 
IUnknown objects 28. COM Persistent Object factory 32 derives from 
Persistence Object Factory 32 and has Type Specific Factories 34 derived from 
20 COM Persistent Object Factory 32. Type Specific Factories 34 are well known 
in the art and can be used to create objects of the multiple classes the user 
chooses to create, and can be persistable according to the present invention. 

A Persistence Controller Interface class 22 derives from IPersistFile 20 
and defines the interface to IPersistFile 20. A COM Persistence Controller 
25 class 24 derives from Persistence Controller Interface 22. COM Persistence 
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Controller class 24 serves to control the existence of objects registered to be 
persistable under the present invention. Class 24 serves to track the existence 
of objects registered to be persistable after the objects are constructed. Class 
24 has a Persistent Object Registry class 26 which serves to store data for class 
5 24. The relationship is indicated at 27. In some embodiments, the 
functionality of class 26 is replaced by a set of attributes residing within class 
24 rather than a separate class. 

A Persistent Object Interface class 38 derives from IPersistStream 36 
and provides the interface to IPersistStream 36. A COM Persistent Object 

10 class 40 derives from Persistent Object Interface 38 and serves to define 
common attributes and methods for user defined objects which derive from it. 
All user-defined objects according to the illustrated embodiment derive from 
COM Persistent Object 40. User Object Definition classes 42 are derived from 
COM persistent Object class 40 and define the user objects which are to be 

15 persistable according to the present invention. User Object Interface classes 
44 derive from User Object Definitions 42 and typically are paired together in 
a one-to-one relationship with the User Object Definitions 42. User Object 
Definitions classes 42 and User Object Interface classes 44 are grouped 
together at User Objects Definitions and Interfaces 54. There are typically as 

20 many different User Object Definitions are there are different user defined 
classes. 

A COM Persistence Reference Class 46 resolves to Persistent Object 
Interface class 38. A COM Persistent Reference Base class 48 finds objects 
using Persistence controller Interface 22, indicated at 49- COM Persistence 
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Reference class 46 derives from COM Persistence Reference Base 48, and has 
a one-to-one relationship with User Object Definitions and Interfaces 54. 

When a user wishes to support persistence in user created COM 
objects, the user needs to write a code to create, save, and load methods to 
5 support streaming, as later described. The user need do little more than that 
to create persistent COM objects according to the present invention. The 
present invention may be described in three parts. COM objects are 
constructed according to Type Specific Factories 34 using User Object 
Definitions 42. The newly created objects are registered with the COM 

10 Persistent Controller 24 in the Persistent Object registry 26. The registered 
information is used later to save and load the objects. The COM objects thus 
registered may later be saved to persistent storage by streaming the objects to 
storage using Persistent Object Interface 38. 

A user defined COM object can be added using User Object Definitions 

15 42 and User Object Interfaces 44 to create objects using Persistent Object 
Factory Interface 30 and COM Persistent Object Factory 32 and Type Specific 
Factories 34 which derive directly or indirectly from IUnknown 28. A COM 
Persistent Object Factory 32 object sends a message to a Persistence 
Controller Interface 22 object to add the newly created object to the database 

20 of registered objects. The Persistence Controller Interface 22 object sends a 
message to a COM Persistence Controller object to register the newly 
constructed object. The object is added to the registry of objects within 
Persistent Object Registry. In one embodiment, the newly created object is 
stored or indexed three ways. The object may be indexed by Class ID, by 

25 Identity, and/or by IUnknown. The Class ID and Identity may be determined 
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by the COM Persistence Controller sending a message to the Persistence 
Object Interface 38 which sends a message to the COM Persistent Controller 
24. The newly constructed object is thus registered within the Persistent 
Object Registry 26. 

5 User defined COM objects may use standard C or C++ language 

pointers. These pointers typically point to other objects. When these objects 
are saved and restored to memory, the objects will likely be in different 
memory locations. The pointer values will thus likely point to garbage values 
if restored, and are thus typically reset to a null value by the method of loading 

10 the saved object from persistent storage. User defined COM objects may also 
use smart pointers according to the present invention, which can be saved and 
restored to reflect the new locations of the objects pointed to after loading. 

The smart pointers have been developed such that the use during 
coding is transparent to the person assigning and referencing smart pointer 

15 values. This is done in part by overloading the assignment operator. When a 
smart pointer is assigned the address of another object, the assignment 
operator uses the address of the object being pointed to, to retrieve the Class 
ID and Identity from the information registered for that object in the 
Persistent Object Registry class, and that information is stored as well. In 

20 particular, the object pointed to has the Class ID stored as well as the address. 
This information can be used when restoring the objects from persistent 
storage. In one embodiment, there is one COM Persistence Reference 46 
object for each smart pointer in a user defined COM object. 

When an object is stored to persistent storage, the Persistence 

25 Controller Interface 22 object sends a message to the COM Persistence 
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Controller 24 object to save the object. The COM Persistence Controller 24 
object creates a stream, and the objects are sent out to the stream, along with 
enough information to later restore the objects. The COM Persistence 
Controller 24 object may send messages to the Persistent Object Registry 26 
5 object, instructing the Persistent Object Registry 26 object to stream out 
header data such as total number of objects, and instruct the Persistent Object 
Registry 26 object to send messages to the COM Persistent Controller 24 and 
COM Persistence Reference 46 objects to stream the objects out. 

In one embodiment, the objects are arranged such that objects having 

10 the same Class ID are grouped together. In one method, the number of 
objects or total size of the objects for each ClassID are streamed out, followed 
by the stream for all objects having the same ClassID, typically prepended by 
the total number or total size of the objects for that ClassID. The stream may 
thus contain a nesting of the objects for each ClassID within each ClassID. 

15 The next object number that would be written, named "NextObjectID" in one 
embodiment, may also be streamed out. 

When the objects are to be loaded from memory, the file name 
containing the objects to be restored has typically been associated with an 
executable portion of code, which may be a DLL (Dynamic Link Library) file. 

20 When the DLL is invoked, a COM Persistence Controller 24 object is created 
in memory. The COM Persistence Controller 24 object may be used to restore 
the saved objects to the state they were in previous to being saved. The COM 
Persistence Controller 24 objects will typically create storage to be used as a 
buffer to store the stream from the objects being restored. 
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The COM Persistence Controller 24 object may instruct the Persistent 
Object Registry 26 object to load, with each newly loaded object registered 
with the COM Persistence Controller 24 object and the Persistent Object 
Registry 26 objects as the objects are being loaded into memory. For each 
5 smart pointer in the objects, the smart pointers contain the Class ID and 
Identity of the object being pointed to. After the objects have been loaded, the 
address portions of the smart pointers maybe restored as well by resolving the 
reference of the objects pointed to, and obtaining the current addresses, to be 
placed into the smart pointers as attributes. The Persistent Object Registry 26 

10 object may send messages to the Persistence Object Interface 38 object to get 
the Class ID and Identity of the objects being referenced. 

In one embodiment, the number of different ClassIDs in the stream is 
read first, then, for each different ClassID, the ClassID is read, followed by the 
number of objects of that ClassID, followed a read of enough of the stream to 

15 read in and load all objects of that ClassID. This is repeated for each different 
ClassID having objects in the stream. The objects are typically first loaded 
into memory, followed by the restoring of the smart pointer values in a 
separate pass. 

Figure 2 illustrates an object interaction diagram (OID) for adding a 
20 persistent object to a COM persistent object controller. The OID may be read 
from left to right and top to bottom, with top to bottom indicating the general 
order of execution and left to right indicating the calling sequence or method 
interactions, generally. An object to be registered with the COM persistence 
controller is passed to COM persistence controller 24 by a client, as indicated 
25 at 100. COM persistence controller 24 passes the object to be registered to 
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Persistent Object Registry 26 RegisterObject method 102, as indicated at 104. 
RegisterObject method 102 is a method from IPersistenceController 22. A 
client calls this method to register an object that supports being persisted by a 
COM persistence controller. The object to be registered must support the 
persistent object interface. RegisterObject method 102 sends a message at 106 
to COM persistent object 40, to query interface method 108 to determine if 
the interface is supported. Next, Persistent Object Registry 26 calls COM 
persistent object 40 method Setldentity 110, as indicated at 112. Setldentity is 
an implementation of IPersistentObject:SetIdentity. Given an object identifier 
as input, Setldentity sets the object ID to the given object identifier. The 
object ID is a unique identifier for each object. The object ID is returned to 
Persistent Object Registry 26, as indicated at 112. Persistent Object Registry 
26 then calls local method AddObjectBylD 114. AddObjectBylD is given an 
IPersistentObject interface and calls IPersistentObject::GetIdentity 116, as 
indicated at 118. Getldentity 116 is implemented as a method of COM 
persistent object 40. Getldentity 116 is an implementation of 
IPersistentObject::GetIdentity. After getting the object ID, AddObjectBylD 
method 114 stores a reference to the object by the object ID in Persistent 
Object Registry 26. Persistent Object Registry 26 then calls 
AddObjectByClassID method 120, which calls COM persistent object 40 
method GetClassID 122, as indicated at 124. GetClassID 122 is an 
implementation of IPersistStream:: GetClassID. GetClassID returns the class 
ID for the object, as indicated at 124. AddObjectsByClassID 120 then stores or 
indexes the object to be added by the class ID. Persistent Object Registry 26 
calls AddObjectByUnknown method 126. AddObjectByUnknown method 126 
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is given an IPersistentObject interface and adds the object or indexes the 
object within Persistent Object Registry 26 by the IUnknown pointer of the 
object. Persistent Object Registry 26 RegisterObject method 102 returns to 
132 as indicated at 130. 

5 Persistent Object Registry 26 maintains at least three collections of all 

registered persistent objects added using an algorithm such as illustrated in 
Figure 2. Persistent Object Registry 26 has an objects-by-ID attribute which is 
a collection of pointers to all registered persistent objects indexed by their 
object identifiers, the object ID is added to by the AddObjectBylD method 114. 

10 The objects-by-class ID attribute is a collection of pointers to all registered 
persistent objects indexed by their class IDs. ObjectsByclass ID is added to by 
the AddObjectByClassID method 120. An ObjectsByUnknown attribute is a 
collection of pointers to all registered persistent objects indexed by their 
IUnknown pointers. ObjectsByUnknown is added to by 

15 AddObjectByUnknown method 126. As each additional object is registered in 
Persistent Object Registry 126, another attribute of the Persistent Object 
Registry is affected, the next object ID. The next object ID is the object 
identifier given to the next object registered by an instance of Persistent 
Object Registry class 26. It is typically incremented for each object and may 

20 be saved and later loaded, allowing an application to continue adding objects 
to be stored in persistence storage. 

Figures 3A-3B are an object interaction diagram for saving a persistent 
registered COM object. Figure 3A shows an illustrative process for saving an 
object registered with Persistent Object Registry 26 to persistence storage. 

25 COM Persistent Object Controller 24 calls Save method 200 to save all 
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registered persistent objects known to Persistent Object Registry 26 in a 
specified file. Save 200 is a method from the standard COM IPersist file. Save 
200 controls the streaming of an object state to a COM compound file storage 
stream. Save 200 creates and opens a COM compound storage and stream. 

5 Save 200 registers the class ID of the COM Persistence Controller class 24 
with the COM compound file storage. When the file created is later to be 
loaded, the class ID of COM Persistence Controller class 24 is used to create a 
copy of COM Persistence Controller 24 using a user- written DLL. 

Persistent Object Controller 24 makes a call to create a Storage. In 

10 particular, a SetClass method 206 and a CreateStream method 208 are called 
to create a stream to be used in streaming out the objects. COM Persistence 
Object Controller 24 then calls SaveObjects method 210 of Persistent Object 
Registry 26, passing the stream retrieved, as indicated at 212. The 
SaveObjects method 210, then calls SaveRegistry method 214. SaveRegistry 

15 method 214 causes every persistent object held for every class ID in 
ObjectsByClsID to be written to a given COM compound file storage stream. 
ObjectsByClsID is a collection in Persistent Object Registry 26 created by 
AddObjectbyClassID 120 of Figure 2. There may be multiple objects created 
of the same class ID within ObjectsByClsID. As an overview, SaveRegistry 

20 may save the number of unique class IDs found in ObjectsByClsID, then, for 
each class ID, the class ID is saved along with the number of objects of that 
class. SaveRegistry may then iterate through every object for a given class ID, 
with each object being told to save itself through a call to 
IPersistStream::Save. SaveRegistry 214 completes as indicated at 216 and 



-15- 



Attorney Docket RA 5202 (CST 1028.1120101) Express Mail EF387780230US 

returns to COM PersistObject controller 24 save method 200, as indicated at 
218. 

The steps within SaveRegistry method 214 are indicated as reference 
numerals 230-242 on Figure 3A, and are repeated on Figure 3B and are 

5 further explained with reference to Figure 3B. 

Figure 3B illustrates an object interaction diagram for saving a 
persistent registered COM object. Figure 3B illustrates SaveRegistry method 
214 in greater detail. In some embodiments of the invention, objects may be 
stored in any order, with the associated class ID. In a preferred embodiment 

10 of the invention, however, the objects stored are grouped by common class ID. 
In one method, as illustrated in Figure 38, the total number or size of objects 
is first written by SaveRegistry method 214, as indicated at 230. SaveRegistry 
method 214 writes the size of all objects to a Stream as indicated at 250. 
WriteSizeofObjects 250 can include writing the total size of all objects to be 

15 written to persistence storage. SaveRegistry 214, as indicated at 232, then 
writes the class ID as indicated at 252. The class ID for each group of objects 
sharing that class ID may be written at 252. Upon reload, this class ID will be 
used to load the classes and register the loaded objects with Persistent Object 
Registry 26. Write step 252 will typically be executed once for each unique 

20 class ID having objects to be written. 

SaveRegistry method 214, as indicated at 234, may then write the 
number of objects to be written for a particular class ID at write step 254. 
Write step 254 is typically executed once for each unique class ID having 
objects to be stored. SaveRegistry method 214, as indicated at 236, may then 

25 call save method 260 of COM Persistent Object 40. Save 260 is a virtual 
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method meant to be overridden by classes derived from COM Persistent 
Object 40. Save 260 provides derived classes with notification that they 
should save their state. Derived classes interested in persisting must override 
save, call COM PersistentObject::Save, and persist their own state. Save, as 

5 implemented in COM Persistent Object, saves object ID via the given COM 
IStream interface. Save method 260, as indicated at 262, however, writes the 
unique object ID to the stream at Write step 256. After loading, the unique 
object ID for the object saved will be restored, and may be used to restore 
pointers pointing to the object, as well. Save method 260 then calls Savei 

10 method 264. 

Savei is an implementation of IPersistStream::Save. Given a COM 
IStream interface, Savei calls Save. Savei is written by the user to stream out 
the user-defined object, such as illustrated in Figure 1 at 54- Save method 
260, as indicated at 266, then passes a message to COM Persistence Reference 

15 38. COM Persistence Reference 38 then calls Write step 268 to write the 
smart pointers of the object being stored to the stream. As discussed 
elsewhere, the smart pointers include, or can include, both the address of the 
object being pointed to and the object ID of the object being pointed to. In 
this way, Write step 252 is repeated for each unique class ID having objects to 

20 be saved. 

Write steps 256 and 258 are iterated through for each object within a 
class to be written. Write step 268 maybe repeated for each smart pointer to 
be written to the stream. After all objects have been saved, a Write step 270 is 
executed to write the next object ID to be assigned. The next object ID is 
25 typically an integer incremented for every new object added to COM 
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Persistent Object Registry 26. At this point, the saving of the registered COM 
objects to persistent storage is complete. 

Figures 4A-4C are an object interaction diagram for loading COM 
objects from a Storage into a COM Persistent Object controller. COM 

5 Persistence Controller 24 calls a load method 300 which makes a call to an 
open storage method 302, as indicated at 304. Open Storage method 302 
creates an open stream with OpenStream step 306, returning to COM 
Persistence Controller 24, as indicated at 308. Load method 300, as indicated 
at 314, calls Persistent Object Registry 26 and LoadObjects method 320. 

10 LoadObjects begins the load process and returns the result of calling 

subsequent steps. COM Persistence Controller 24 and Load method 300, as 
indicated at 316, then calls InitCollections step 322 of Persistent Object 
Registry 26. InitCollections step 322 initializes a LoadRegistry step 324- 
LoadRegistry step 324 may then begin, iterating over all classes and objects 

15 previously saved. Essentially, the load process loads the objects previously 
saved, in the order expected. Much of the load process is performed by the 
Loadi method which is user-supplied, created to load, or stream in the objects 
previously saved using Savei. At 326, a Read(clsid) step 328 is executed to 
read the number of unique class IDs previously saved in the storage. As 

20 indicated at 330, a Read step 332 is executed to read the class ID for a class 
having objects stored according to that class. Read step 322 may be expected 
and be repeated once for each unique class having one or more objects stored 
that belong to that class. As indicated at 334, a Read step 334 is executed to 
read the number of objects that are stored for the class ID given in step 332. 

25 As indicated at 336, a call is made to CoCreatelnstance step 338 to create an 
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instance for the class ID. The load methods within Persistent Object Registry 
26 continue at 350 on Figure 4B. 

Figure 4B illustrates the second part of the load scheme according to 
the present invention. As indicated at 350, a Load method 352 is called on 
5 COM Persistent Object 40, as indicated at 350. Load step 352, as indicated at 
354, performs a read on the A Stream, as indicated at 356. Read step 356 
reads the unique object ID for the object being loaded, and returns that 
unique object ID. A Loadi method 358 of COM Persistent Object 40 is then 
called which in turn calls a Read step 360 on A Stream. Read step 360 reads 

10 the object data saved by the user-written Savei method previously discussed. 
Loadi is an implementation of IPersistStream::Load. Given a COM IStream 
interface, Load calls Loadi. Loadi is illustrated as step 358 in Figure 4B. A 
Load return step 362 returns control as indicated at 363, indicating that load 
of the given object is complete. 

15 Persistent Object Registry 26 executes a RegisterLoadedObject step 

364. RegisterLoadedObject step 364 adds an object just loaded from 
Persistence into ObjectsBylD, ObjectsByClsID, and ObjectsByUnknown. The 
process thus followed is similar to the initial registering of newly constructed 
objects previously discussed. An AddObjectBylD step 366 calls a GetID step 

20 368, which returns the object ID. An AddObjectByClsID step 370 calls a 
GetClassID step 372, which returns the unique class ID for the class of the 
loaded object. An AddObjectByUnknown step 374 adds the object by 
unknown into Persistent Object Registry 26, as previously discussed. 
RegisterLoadedObject step 364 thus iterates over each object, as indicated by 

25 376. LoadRegistry Step 324 of Figure 4A iterates over all classes having 
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objects, as indicated at 387 in Figure 4B. After loading all objects, execution 
proceeds, as indicated at 380, with execution of a Read method on A Stream, 
as indicated at 382. Read step 382 retrieves the NextObjectID to be used by 
the Persistent Object Registry 26. 

5 Figure 4C illustrates the third part of the object interaction diagram for 

loading COM objects from A Storage into a COM Persistent Object Controller. 
With all objects loaded into memory, a ResolveReferences step 400 is 
executed within Persistent Object Registry 26. ResolveReferences step 400 
iterates through all references that require resolving. One such reference- 

10 resolving step, indicated at 402, calls ResolveReferences 404 of COM 
Persistent Object 40. Generally, ResolveReferences step 404 is responsible for 
telling each persistent object to initiate the conversion of persistent object 
references into actual pointers. ResolveReferences step 404 iterates, as 
indicated at 406 and 408, through all objects held in ObjectsBylD in 

15 Persistent Object Registry 26, calling ResolveReferences method 410 of 
Persistent Object Registry 26. Each smart pointer of an object is thus 
instructed to use the object's ID held within the smart pointer to retrieve the 
current address of the object having that object ID from the ObjectsBylD 
collection in Persistent Object Registry 26. 

20 ResolveReferences method 410 calls FindObject method 412 of COM 

Persistence Controller 24. FindObject is a method from IPersistence 
Controller. A client calls this method to find a particular persistent object 
based on an object identifier. FindObject calls 

PersistentObjectRegistry::FindObject. The iteration of ResolveReferences 

25 method 400 over all objects having such references as indicated at 414 
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resolves all references. After resolving all references, control is returned at 
416 to Load method 300, initially begun on Figure 4A. 

Example Objects and Methods 

1 The COM Persistence Controller 

The Persistence Controller manages the streaming of persistent objects to 

and from a COM Compound-File Storage. The COM Persistence Controller is 
implemented as a stand alone DLL. As such, clients use the COM Persistence 
Controller to manage the streaming of disparate COM objects to and from a 
COM Compound-File Storage Stream. 

A COM Compound-File Storage is a concept within COM itself. 
Conceptually, a COM Compound-File Storage can be considered a directory 
structure. This directory structure is composed of "files" called Streams. The 
COM Persistence Controller persists objects to a single Stream within a COM 
Compound-File Storage. 

1.1 Persistence Controller Interface (22) 

The Persistence Controller Interface (IPersistenceController) is a pure 

virtual class. IPersistenceController extends the standard COM IPersistFile 
interface. A class implementing IPersistenceController can respond to normal 
COM File Moniker operations. The use of a COM File Moniker allows a client 
program to activate the COM Persistence Controller with only a filename. 

1.1.1 SetControllerName 

This method allows a caller to set the name for a Persistence Controller. 

The Persistence Controller uses this name to identify the COM Compound- 
File Storage Stream. 
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1.1.2 RegisterObject 

This method allows a caller to register an object that supports being 

streamed by a Persistence Controller. 

1.1.3 FindObject 

5 This method allows a caller to find a particular object registered with 

the Persistence Controller. 

1.1.4 EnumObjects 

This method allows a caller to enumerate all objects of a particular COM 

class. 

10 1.2 COM Persistence Controller Class (24) 

The COM Persistence Controller class is an implementation of the 

Persistence Controller Interface. As such, the COM Persistence Controller 
class supports all methods of IPersistFile and IPersistenceController. In 
general, the COM Persistence Controller class delegates most of its 
15 functionality to the Persistent Object Registry. Section 1.3 describes the 
operation of the Persistent Object Registry. 

1.2.1 Attributes 

1.2.1.1 ObjectRegistry 

This is an aggregated instance of Persistent Object Registry. 

20 1.2.1.2 Name 

This is the name of the COM Persistence Controller. The default name 

is "-DefaultController-". This attribute becomes the name of the Stream 
within the COM Compound-File Storage. 
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1.2.2 Methods 

1.2.2.1 ConstructoO 

ConstructO is the constructor for the COM Persistence Controller Class. 

It is responsible for creating and initializing the ObjectRegistry. 

5 1.2.2.2 DestructO 

DestructO is the destructor for the COM Persistence Controller Class. 

It is responsible for destructing the ObjectRegistry. 

1.2.2.3 GetClassID() 

This is a method from the standard COM IPersistFile. GetClassID() 

10 returns the CLSID associated with the COM persistent storage medium. This 
is always the CLSID of the COM Persistence Controller. 

1.2.2.4 IsDirtyO 

This is a method from the standard COM IPersistFile. IsDirtyO returns 

an indication of whether or not any of the objects have been modified since 
1 5 the last call to Save(). 

1.2.2.5 Load() 

This is a method from the standard COM IPersistFile. LoadO controls 
the creation of objects from object state saved in a COM Compound-File 
Storage Stream. 

20 Load 0 opens the specified COM Compound-File Storage and Stream. 

Load() then calls PersistentObjectRegistry::LoadObjects(). 

1.2.2.6 Save() 

This is a method from the standard COM IPersistFile. Save() controls 
the streaming of object state to a COM Compound-File Storage Stream. 
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Save() creates and opens a COM Compound-File Storage and Stream. 
Save() registers the CLSID of the COM Persistence Controller class with the 
COM Compound-File Storage. Save() then calls 

PersistentObjectRegistiy::SaveObjects(). 

1.2.2.7 SaveCompletedO 

This is a method from the standard COM IPersistFile. In the most 

general sense, the semantics of IPersistFile: :Save() do not require 
synchronous behavior. A client calls SaveCompleted to get an indication of 
whether or not an asynchronous save operation is complete. Because all save 
operations performed by the COM Persistence Controller are synchronous, 
SaveCompletedO always returns true. 

1.2.2.8 GetCurFileO 

This is a method from the standard COM IPersistFile. GetCurFile 

returns the name of the currently open COM Compound-File Storage. 

1.2.2.9 SetControllerNameO 

This is a method from IPersistenceController. A client calls this 

method to establish a name of the COM Compound-File Storage Stream to 
and from which objects are persisted. 

1.2.2.10 RegisterObjectO 

This is a method from IPersistenceController. A client calls this 

method to register an object that supports being persisted by a COM 
Persistence Controller. The object to be registered must support the 
Persistent Object Interface. 

RegisterObject calls PersistentObjectRegistry::RegisterObject. 
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1.2.2.11 FindObject() 

This is a method from IPersistenceController. A client calls this 

method to find a particular persistent object based on an object identifier. 
FindObject calls PersistentObjectRegistry::FindObject. 

1.2.2.12 EnumObjectsO 

This is a method from IPersistenceController. A client calls this 

method to obtain a collection of persistent objects given a CLSID. 
EnumObjects calls PersistentObject Registry: :EnumObjects. 

1.3 Persistent Object Registry Class (26) 

The Persistent Object Registry class tracks all registered persistent 

objects. This tracking is done through several different collections. 

1.3.1 Attributes 

1.3.1.1 Controller 

This is a pointer to the IPersistenceController interface supported by an 

instance of the COM Persistence Controller class aggregating an instance of 
the Persistent Object Registry class. 

1.3.1.2 NextObjectld 

This is the object identifier given to the next object registered by an 

instance of the Persistent Object Registry class. 

1-3-1-3 ObjectsByld 

This is a collection of pointers to all registered persistent objects 

indexed by their object identifiers. 

1.3.1.4 ObjectsByClsid 

This is a collection of pointers to all registered persistent objects 

indexed by their CLSIDs. 
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1.3.1.5 ObjectsByUnknown 

This is a collection of pointers to all registered persistent objects 

indexed by their IUnknown pointers. 

1.3.2 Methods 

1.3.2.1 ConstructoO 

Construct^) is the constructor for the Persistent Object Registry Class. 

ConstructO is responsible for the construction and initialization of all object 
attributes. 

1.3.2.2 DestructO 

DestructO is the destructor for the Persistent Object Registry Class. 

DestructO is responsible for the destruction of all object attributes. 

1.3.2.3 RegisterObjectO 

RegisterObjectO validates that the input object supports persistence 

through the COM Persistence Controller (i.e. the object supports 
IPersistentObject). 

If the object supports persistence through the COM Persistence 
Controller, RegisterObject assigns the persistent object the object identifier in 
NextObjectld. RegisterObjectO assigns the object identifier by calling 
IPersistentObject: :SetIdentity(). 

RegisterObjectO increments NextObjectld. 

Finally, RegisterObjectO calls AddObjectByldQ, AddObjectByClsidO, 
and AddObjectByUnknown(). 
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1.3.2.4 FindObject() 

FindObjectO attempts to find a persistent object given its object 

identifier. FindObject indexes the ObjectsByld collection. FindObjectO 
returns the resulting IPersistentObject pointer. 

5 1.3.2.5 EnumObjectsO 

EnumObjectsO returns all persistent objects of a given COM type 

(CLSID). EnumObjects indexes the ObjectsByClsid collection and returns all 
the IPersistentObject pointers based the given CLSID. 

1.3.2.6 SaveObjects() 

10 SaveObjectsO returns the result of calling SaveRegistry(). 

1.3.2.7 LoadObjectsO 

LoadObjectsO returns the result of calling InitializeCollectionsO, 

LoadRegistryO, and ResolveReferences(). 

1.3.2.8 SaveRegistryO 

15 SaveRegistryO causes every persistent object held for every CLSID in 

ObjectsByClsid to be written to a given COM Compound-File Storage Stream. 

SaveRegistryO first saves the number of unique CLSIDs held in 
ObjectsByClsid. 

SaveRegistryO then iterates through each CLSID held in 
20 ObjectsByClsid. Each CLSID is saved along with the number of objects of that 
class. 

SaveRegistryO then iterates through every object of the given CLSID. 
Each object is told to save itself through a call to IPersistStream::SaveO- 

After all objects have been saved, SaveRegistryO writes NextObjectld to 
25 the COM Compound-File Storage Stream. 
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1.3.2.9 LoadRegistryO 

LoadRegistryO restores objects from state held in a given COM 

Compound-File Storage Stream. 

LoadRegistryO first loads the number of unique CLSIDs held in the 
Compound-File Storage Stream. 

Given the number of unique CLSIDs held in persistence, 
LoadRegistryO reads the next CLSID and the number of objects of that type. 

Given the number of objects of a given CLSID, LoadRegistryO requests 
that COM create and instance of the given CLSID through a call to 
CoCreateInstance(). CoCreatelnstanceO is a standard COM API for creating 
object instances. 

Having created and object of a particular type, LoadRegistryO tells the 
object to load itself through a call to IPersistStream::Load(). 

Once an object has loaded itself, LoadRegistryO calls 
RegisterLoadedObject(). 

After all objects have been loaded, LoadRegistryO reads NextObjectld 
from the COM Compound-File Storage Stream. 

1.3.2.10 InitializeCollectionsO 

InitializeCollectionsO clears the contents of ObjectsByld, 

ObjectsByClsid, and ObjectsByUnknown. 

1.3.2.11 RegisterLoadedObjectO 

RegisterLoadedObjectO adds an object just loaded from persistence 

into ObjectsByld, ObjectsByClsid, and ObjectsByUnknown. 
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1.3.2.12 ResolveReferencesO 

Persistent objects can hold references to other persistent objects. 

When loaded in memory, persistent objects reference other persistent objects 
with normal pointers. When saved, persistent object references can no longer 
be normal pointers. Persistent object references become object identifiers. 

The process of loading objects from persistence includes turning object 
identifiers back into pointers. 

Each persistent object is responsible for converting any persistent 
object references into pointers. 

ResolveReferencesO is responsible for telling each persistent object to 
initiate the conversion of persistent object references into actual pointers. 

ResolveReferencesO iterates through all objects held in ObjectsByld 
calling IPersistentObject: :resolveReferences(). 

1.3.2.13 AddObjectByldO 

Given an IPersistentObject interface, AddObjectByldO calls 

IPersistentObject: :GetIdentity() to retrieve the object identifier. 

AddObjectByldO then adds the object into ObjectsByld based on the 
object identifier. 

1.3.2.14 AddObjectByClsidO 

Given an IPersistentObject interface, AddObjectByClsidO calls 

IPersistentStream::GetClassID() to retrieve the CLSID of the object. 

AddObjectByClsidO then adds the object to ObjectsByClsid based on 
the CLSID. 



-29- 



Attorney Docket RA 5202 (CST 1028.1120101) Express Mail EF387780230US 

1.3.2.15 AddObjectByUnknownO 

Given an IPersistentObject interface, AddObjectByUnknownO adds the 

object to ObjectsByUnknown. 

2 COM Persistent Object Support 

This section describes interfaces and classes that act as support for 

persistent COM objects. The use of these classes permits rapid development 
of COM objects capable of being persisted by the COM Persistence Controller 
as embodied in the COM Persistence Controller DLL. 

2.1 Persistent Object Interface (38) 

The Persistent Object Interface (IPersistentObject) is a pure virtual class. 

IPersistentObject extends the standard COM IPersistStream interface. In 
general, any COM object supporting IPersistentObject can be persisted by the 
COM Persistence Controller. 

2.1.1 SetldentityO 

This method allows a caller to assign a persistent object a unique 

identifier. 

2.1.2 GetldentityO 

This method allows a caller to retrieve the unique identifier of a 

persistent object. 

2.1.3 ResolveReferencesO 

This method provides a persistent object with notification that it should 

resolve references to other persistent objects. 

2.2 COM Persistent Object Class (40) 

The COM Persistent Object class is an implementation of the Persistent 

Object Interface. As such, the COM Persistent Object class supports all 
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methods of IPersistStream and IPersistentObject. Furthermore, COM 
Persistent Object is an abstract base class for all classes of persistent objects. 

2.2.1 Attributes 

2.2.1.1 Classld 

Classld holds a reference to the CLSID of this object. 

2.2.1.2 IsDirty 

IsDirty is a COM HRESULT value that indicates whether or not an 
object has changed state since the last call to Savei(). IsDirty can have a value 
of S_OK, meaning the state has changed since the last call to Savei(). IsDirty 
can also have a value of S_FALSE, meaning the state has not changed since 
the last call to Savei(). The IsDirty attribute is returned directly from the 
IPersistStream: :IsDirty() implementation. 

2.2.1.3 Objectid 

Objectld holds the object identifier for this object as established by 

SetldentityO. 

2.2.1.4 References 

References is a collection of pointers to persistent object references 

within an object. That is, References is a collection of pointers to object 
derived from the ComPersistenceRefenceBase class. This collection of 
persistent object reference pointers is used during the persistent object 
reference resolution process. This process is initiated through 
IPersistentObj ect: : ResolveRefererenceQ. 
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2.2.2 Methods 

2.2.2.1 ConstructoO 

ConstructO is the constructor for the COM Persistent Object Class. 

Construct*) takes one parameter, the CLSID of the persistent COM class 
derived from the COM Persistent Object class. ConstructO initializes all object 
attributes. 

2.2.2.2 DestructO 

DestructO is the destructor for the COM Persistent Object class. 

DestructO destroys all object attributes. 

2.2. 2.3 AddReference() 

AddReferenceO provides a means by which instances of classes derived 

from COM Persistent Reference Base can register themselves as belonging to 
this COM Persistent Object instance. 

Given a persistent object reference, AddReferenceO add a pointer to 
the persistent object reference to References. 

2.2.2.4 RemoveRefer ence() 

RemoveReferenceO provides a means by which instances of classes 

derived from COM Persistent Reference Base can deregister themselves as 
belonging to this COM Persistent Object instance. 

Given a persistent object reference, RemoveReferenceO deletes the 
pointer to the persistent object reference from References. 

2.2.2.5 Load() 

LoadO is a virtual method meant to be overridden by classes derived 
from COM Persistent Object. 
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Load() provides derived classes with notification that they should load 
their state. Derived classes interested in retrieving persistent state must 
override Load(), call ComPersistentObject::Load(), and retrieve their own 
state. 

Load() ? as implemented in COM Persistent Object, loads Objectld via 
the given COM IStream interface. 

2.2.2.6Save() 

Save() is a virtual method meant to be overridden by classes derived 
from COM Persistent Object. 

SaveO provides derived classes with notification that they should save 
their state. Derived classes interested in persisting state must override Save() 5 
call ComPersistentObject::Save(), and persist their own state. 

Save() ? as implemented in COM Persistent Object, saves Objectld via 
the given COM IStream interface. 

2,2.2.7 InvalidateO 

InvalidateO provides a means by which classes derived from COM 

Persistent Object set the IsDirty flag. 

InvalidateO sets IsDirty to S_OK. 

2.2.2.8IsValid() 

IsValidO provides a means by which classes derived from COM 

Persistent Object can test the IsDirty flag. 
IsValidO returns IsDirty != SJ3K. 

2.2.2.9GetClassID() 

GetClassIDO is an implementation of IPersistStream::GetClassID(). 
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2.2.2.10 IsDirtyO 

IsDirtyO is an implementation of IPersistStream::IsDirty(). 

IsDirtyO returns Is Dirty. 

2.2.2.11 Savei() 

Savei() is an implementation of IPersistStream::Save(). 

Given a COM IStream interface, Savei() calls Save() if IsValidO returns 

false. 

SaveiO also sets IsDirty appropriately as per the fClearDirty parameter. 

2.2.2.12 Loadi() 

Loadi() is an implementation of IPersistStream::Load(). 

Given a COM IStream interface, Loadi call Load(). 

2.2.2.13 GetMaxSizeO 

GetMaxSizeO is an implementation of IPersistStream:: GetMaxSizeO . 

GetMaxSizeO is an optionally implemented method. 
GetMaxSizeO return the COM status of E_NOTIMPL. 

2.2.2.14 SetldentityO 

SetldentityO is an implementation of IPersistentObject::SetIdentity(). 

Given an object identifier as input, SetldentityO sets ObjectID to the given 
object identifier. 

2.2.2.15 GetidentityO 

GetldentityO is an implementation of IPersistentObject::GetIdentity(). 

GetidentityO return ObjectID. 
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2.2.2.16 ResolveReferencesO 

ResolveReferencesO is an implementation of 

IPersistentObject::ResolveReferences(). 

For each persistent object reference held in References, 
ResolveReferencesO calls ComPersistentReferenceBase: : ResolveReference() 
passing the input IPersistenController interface. 

2.3 COM Persistent Reference Base Class (48) 

The COM Persistent Reference Base class is the base class for all classes 

that implement references to COM Persistent Objects. In general, COM 
Persistent Reference Base defines the general protocol used to maintain 
persistent object references. 

2.3.1 Attributes 

2.3.1.1 Owner 

This is a pointer to the COM Persistent Object instance that owns this 
COM Persistent Reference Base instance. 

2.3.1.2 Pointeeldentity 

This is the object identifier of the referenced persistent object. Pointee 

Identity is established when a derived class is constructed, or when a derived 
class assigns a new persistent object reference. 

2.3.2 Methods 

2.3.2.1 ConstructoO 

ContructoO is the default constructor. It takes two parameters. The 

first parameter is a COM Persistent Object pointer that will be assigned as 
Owner. The second parameter is the object identifier of COM Persistent 
Object being referenced. 



-35- 



Attorney Docket RA 5202 (CST 1028.1120101) Express Mail EF387780230US 

Upon construction, Owner is set to the input owner. Pointee Identity is 
set to the input pointee identity, and Owner AddReferenceO is called. 

2.3.2.2 ConstructCopyO 

ConstructCopyO is the copy constructor. When a new COM Persistent 

Reference Base is created from another instance, the Owner and Pointee 
Identifier are copied from the source instance. 
Owner.AddReference() is also called. 

2.3.2.3AssignO 

Assign() is the assignment operator. When an existing COM Persistent 
Reference Base is assigned from another instance, Owner. RemoveReference() 
is called, Owner and Pointee Identifier are copied from the source instance, 
and Owner.AddReference() is called. 

2.3.2.4DestructO 

DestructO is the destructor. When an existing COM Persistent 

Reference Base is destroyed, Owner. RemoveReferenceO is called. 

2.3.2.5 ResolveReferenceO 

ResolveReferenceO is a virtual method that is to be overridden by a 

derived class. 

ResolveReferenceO takes an IPersistenceController as input. 
The implementation of ResolveReferenceO within this class calls 
IPersistenceController: :FindObjectO passing Pointee Identity. 
ResolveReferenceO returns the result of this call. 
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2.3.2.6 SetldentityO 

SetldentityO takes as input the object identifier that will be assigned to 

Pointeeldentity. 

A derived class calls this method whenever the derived class changes 
the value of its persistent object reference outside of assignment of Com 
Persistent Reference Base. 

SetldentityO sets Pointee Identity to the input object identifier. 

2.3.2.7 StreamOutO 

StreamOutO is the C++ operator «() member function. 

StreamOutO takes one parameter as input, the COM stream to which 
object state is to be written. 

When called, StreamOutO writes Pointeeldentity to the COM stream. 

2.3.2.8StreamIn() 

StreamlnO is the C++ operator »() member function. 

StreamlnO takes one parameter as input, the COM stream from which object 
state is to be obtained. 

When called, StreamlnO reads Pointeeldentity from the COM stream. 

2.4 COM Persistent Reference Class (46) 

COM Persistent Reference class is a template class that provides a 

concrete implementation of a COM persistent reference. That is, the COM 
Persistent Reference class essentially implements a COM persistent pointer. 
Template parameters include the COM interface type and pointer to the COM 
interface IID. 
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2.4.1 Attributes 

2.4.1.1 Pointee 

Pointee is of type ATL CComPtr< Interface >. 

Pointee holds the reference to an actual COM interface supported by a 
5 persistent COM object. 

2.4.2 Methods 

2.4.2.1 ConstructoO 

ConstructoO is the default constructor. It takes two parameters. The 

first parameter is a pointer to a COM Persistent Object that will be assigned as 
10 Owner in the base class. The second parameter is an interface pointer to the 
persistent object. 

ConstructoO passes the COM Persistent Object pointer to the base class 
ConstructoO along with the result of calling GenerateldentityO against the 
input interface pointer. Pointee is also initialized with the input interface 
15 pointer. 

2.4.2.2 ConstructCopyO 

ConstructCopyO is the copy constructor. ConstructCopyO invokes the 

base class ConstructCopyO with source object. ConstructCopyO also copies 
Pointee from the source object. 

20 2.4.2.3Assigno() 

AssignoO is the assignment operator taking a COM Persistent 

Reference object as an input parameter. 

AssignoO validates that the source object is not the target object. 
AssignoO then invokes the base class AssignO with the source object. 
25 AssingoO assigns Pointee from the source object to the target obj ect. 
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2.4.2.4Assigni() 

AssigniO is the assignment operator taking an interface pointer as an 

input parameter. 

AssigniO assigns Pointee from the source interface pointer. 

AssingiO calls SetldentityO with the result of calling 
GenerateldentityO using the source interface pointer as input. 

2.4.2.5 DestructO 

DestructO is the destructor. It destructs the Pointee and invokes the 

base class Destruct(). 

2.4.2.6Dereferenceo() 

This is the C++ operator ->() member function. 

It DereferenceoO returns Pointee: operator ->(). 

2.4.2.7 DereferenceiO 

This is the C+ + operator *() member function. 

DereferenceiO returns Pointee:: operator *(). 

2.4.2.8 ConvertoO 

This is the C++ operator Pointee *()- 

ConvertoO returns Pointee: operator Pointee *(). 

2.4.2.9ResolveReference() 

ResolveReferenceO is called to reestablish Pointee following a load of 

state from persistence. 

ResolveReferenceO calls the base class ResolveReferenceO which 

returns an IPersistentObject pointer. 

ResolveReferenceO queries the returned interface pointer for the 
interface to which the COM Persistent Reference is associated. 



-39- 



Attorney Docket RA 5202 (CST 1028.1120101) Express Mail EF387780230US 

The result of the query is stored into Pointee. 

2.4.2.10 GenerateldentityO 

GenerateldentityO is a private member function. 

GenerateldentityO, given a COM interface pointer, queries for 
IPersistentObject. 

GenerateldentityO then calls IPersistentObject: :getldentity0 and 
returns the result. 

Numerous advantages of the invention covered by this document have 
been set forth in the foregoing description. It will be understood, however, 
that this disclosure is, in many respects, only illustrative. Changes may be 
made in details, particularly in matters of shape, size, and arrangement of 
parts without exceeding the scope of the invention. The invention's scope is, 
of course, defined in the language in which the appended claims are 
expressed. 
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